package com.study.map.service;

import com.study.map.dto.PoiRequest;
import com.study.map.dto.PoiResponse;
import com.study.map.exception.MapServiceException;

/**
 * POI搜索服务接口
 *
 * @author study
 * @date 2025-08-31
 */
public interface IPoiService {

    /**
     * POI搜索：根据关键字搜索兴趣点
     *
     * @param request POI搜索请求参数
     * @return POI搜索结果
     * @throws MapServiceException 地图服务异常
     */
    PoiResponse poiSearch(PoiRequest request) throws MapServiceException;

    /**
     * POI搜索：根据关键字搜索兴趣点
     *
     * @param keywords 查询关键字
     * @param city 城市
     * @return POI搜索结果
     * @throws MapServiceException 地图服务异常
     */
    PoiResponse poiSearch(String keywords, String city) throws MapServiceException;
}